home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / trans.com / READ.ME < prev    next >
Encoding:
Text File  |  1990-02-02  |  3.9 KB  |  103 lines
  1. TRANSLAT and KEYWORD
  2.  
  3. Copyright 1990
  4.  
  5. by Gil Yoder
  6. P.O. Box 307
  7. Coalgate, OK 74538
  8.  
  9. Permission is granted to copy and distribute (but not to sell)
  10. all the files included in this archive without modification.
  11. Distributors may charge a small handling fee to cover their
  12. expenses.  Registration is not required, but a small donation
  13. sent to the above address will be appreciated.
  14.  
  15. Other programs from this author can be found on various BBS's.
  16. The Coalgate BBS will usually have the latest versions of my
  17. programs, and will be the quickest means of support for them.
  18. Call the Coalgate BBS at 405 927-2541 (HST 14.4 supporting 9600,
  19. 4800, 2400, 1200, 300 bps, 8-N-1).  Give it a call.
  20.  
  21. INSTRUCTIONS:
  22.  
  23. On this disk are two programs, TRANSLAT.EXE and KEYWORD.EXE, a
  24. batch file to provide help for TRANSLAT.EXE, and source code for
  25. the two programs for those wishing to modify. TRANSLAT.EXE is a
  26. program that will allow you to remap from one to five keys on
  27. your keyboard.  The KEYWORD program is a utility that reports the
  28. values that DOS uses for the keystrokes it receives from the
  29. keyboard.
  30.  
  31. To make one keystroke appear to be another keystroke you should
  32. first run KEYWORD and press the key to be translated, and the key
  33. you wish it to be translated to.  KEYWORD will report the value
  34. for each key.  When you are finished with KEYWORD, press ESC.
  35.  
  36. Then using the values you obtained with KEYWORD run TRANSLAT with
  37. the following syntax:
  38.  
  39. TRANSLAT oldkey newkey
  40.  
  41. where oldkey is the value reported by keyword for the key to be
  42. changed and newkey is the value of the key to be returned when
  43. the old key is pressed.  Up to five "oldkey newkey" combinations
  44. can be specified on the command line.  Note that the values must
  45. be entered following strict rules:
  46.  
  47. (1) Each key must be a 4 digit hex number, left padded with 0's
  48.     if necessary.
  49. (2) There must be at least one pair of numbers.
  50. (3) There must be less than 6 pairs of numbers.
  51. (4) Uneven pairs are not allowed.
  52. (5) Each digit of each values must be one of the following
  53.     characters: 0123456789ABCDE.  Lowercase characters are not
  54.     allowed.
  55.  
  56. If TRANSLATE cannot be successfully installed, you will hear a
  57. beep, and TRANSLATE will return to DOS with an error code.
  58. For an odd number of parameters a code of 1 will be returned.
  59. For no parameters code 2 is returned.  For too many parameters
  60. code 3 is returned.  For improperly formed parameters code 4 is
  61. returned.  TRANS.BAT uses these codes to direct its flow.
  62. Normally when an error occurs you should examine the command line
  63. for a violation of one or more of the preceeding rules.
  64.  
  65. As an example of one installation suppose you have a program that
  66. uses the 5 key on the number pad when numlock is turned off.
  67. Everything appears to work fine at the computer, but when you
  68. access your computer with a dumb terminal you discover that your
  69. terminal will not send a value when you press the 5 key.  From
  70. your terminal run the KEYWORD program and press the 5 key with
  71. numlock off.  KEYWORD will report
  72.  
  73. 4C00 = <Center>
  74.  
  75. Next choose a key to replace the 5 key.  For example we choose
  76. the asterisk on the number pad.  Press the key and KEYWORD will
  77. report
  78.  
  79. 372A = *
  80.  
  81. Next press the escape key.  KEYWORD will report the value of
  82. escape and return you to DOS.
  83.  
  84. Armed with this information we are ready to run TRANSLAT.  To
  85. make the asterisk work like the 5 key we run TRANSLAT with the
  86. following line:
  87.  
  88. TRANSLAT 372A 4C00
  89.  
  90. There are two different ways to have more keys redefined.  You
  91. can run TRANSLAT several times, once for each key, or you can
  92. specifiy more key pairs on the command line.  Because TRANSLAT
  93. installs itself each time you run it, the second method is
  94. preferred.  You can send five key pairs to TRANSLAT.
  95.  
  96. TRANSLAT installs itself as a TSR and remains in memory until the
  97. next time the system is booted, or until the system is powered
  98. down.
  99.  
  100.                           ADDENDUM
  101.  
  102.  
  103.